home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_4 / never-20.lha / Never.doc < prev    next >
Text File  |  1994-11-24  |  10KB  |  250 lines
  1. --------------------------------------------------------------------------
  2. v1.0 September 16 1990
  3. --------------------------------------------------------------------------
  4. PLB:
  5.  
  6. Welcome to The Never Ending Story Door.
  7.  
  8. This is a door I put together today just for the heck of it.
  9.  
  10. To run it just copy it into its own DOORX dir, and rename it to the same
  11. name as the DOORX dir.
  12.  
  13. When run, it will allow you and your users to Read, Add to, or Create up to
  14. 50 stories. There will be a file called 'stories' created or appended to 
  15. when a New story is created, this file will have the list of the available
  16. stories.
  17.  
  18. Also there will be file(s) for each story and they will be named the same
  19. as the story name.
  20.  
  21. This door is written with GFA-Basic using the GFA door routines I put out,
  22. also it includes THE METRO text editor which you are welcome to use in your
  23. own doors. The door routines 'PROCEDURE 3' was modified to allow the text
  24. editor to work.
  25.  
  26. It also is the FIRST ANSI DOOR for THE METRO BBS.
  27.  
  28. Oh: I included the source code in ascii format so you can look and learn!
  29.  
  30. Have fun, and if you find any bugs, let me know.
  31.  
  32. Percy L. Broadnax..... Author of THE METRO BBS
  33.  
  34. THE METRO DETROIT BBS.... 313-893-7773
  35.  
  36. --------------------------------------------------------------------------
  37. v1.2 September 24 1990
  38. --------------------------------------------------------------------------
  39. PLB:
  40.  
  41. Sorry but a bug slipped into the code, a GOTO with the wrong line label.
  42. Seems like the compiler should have spotted this, but it did not. Anyways
  43. if you tried to put ANSI in the message, GURU city. This has been fixed.
  44.  
  45. Also new: you can enter the number of the story you want to read instead
  46. of the complete filename.
  47.  
  48. --------------------------------------------------------------------------
  49. v1.95 June 5 1991
  50. --------------------------------------------------------------------------
  51. PFD:
  52.  
  53. The above were Percy's docs for the door. I decided to start working on
  54. doors in GFA Basic, so the first thing I did was have a very good look at
  55. the Never Ending Story code. I'm sorry, I couldn't resist, so decided to
  56. have a good hack around with it to see what I could add.
  57.  
  58.  
  59. For users who are now running Never Ending Story:
  60. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61. If upgrading from the early versions of the Never Ending Story here's what
  62. you MUST do:
  63.  
  64. Your old file called 'Stories' needs a new format. This was the only
  65. thing I had to change so the [N]ew lines bit works. Let's say your old
  66. Stories file looked like this:
  67.  
  68. STORY NAME 1
  69. STORY NAME 2
  70. STORY NAME 3
  71. STORY NAME 4
  72. STORY NAME 5
  73. STORY NAME 6
  74.  
  75. Load it into a text editor and make it look like this:
  76.  
  77. STORY NAME 1
  78. 0
  79. STORY NAME 2
  80. 0
  81. STORY NAME 3
  82. 0
  83. STORY NAME 4
  84. 0
  85. STORY NAME 5
  86. 0
  87. STORY NAME 6
  88. 0
  89.  
  90. You MUST do this before running the door. I was going to do a program
  91. to convert the old 'stories' files over, but I'm sure you can manage
  92. to add a zero after every line in your 'stories' file okay!
  93.  
  94. The number you have to add is the index number for that story, and if
  95. the story is added to, you'll see that value go up. Make it zero for the
  96. start - then your old stories will not come up as NEW for the first time a
  97. user visits the new door. If you want them to come up as New, use a '1'
  98. instead of a zero. Your old stories files are compatible, except the [N]ew
  99. lines option won't work for those yet. The users will have to read it from
  100. the beginning. Once the stories are added to, however, this feature will
  101. work like a treat.
  102.  
  103.  
  104. For all users:
  105. ~~~~~~~~~~~~~~
  106. Firstly the code has been re-structured somewhat to make it a little easier
  107. to modify in the future. You won't see much difference when running the
  108. door, but you will if listing the source (which is included in ASCII form).
  109.  
  110. The screen will open the same size as the settings you have in the 
  111. s:metro.config file, meaning us blokes with PAL can open a 640*256 screen.
  112. US sysops will have to be content with the 640*200, as they'll have in the
  113. metro.config. The window itself is opened up a whole 11 pixels down from 
  114. the top of the screen, making it possible to click on the screen-to-back
  115. gadgets that were actually there in the old version, except not accessible.
  116.  
  117. The door checks for ram:doordata. If it's there it will know whether the
  118. user has ANSI or not, and open in the appropriate colours. If the door
  119. has been run off a main BBS menu (not the dhandler) we can't find out
  120. the ANSI setting, and so have to ask the user.
  121.  
  122. The main addition is the keeping of a door index which records the number
  123. of door invocations. With this, it is possible to read each story which
  124. has NEW LINES in it since the user's last visit to the door. Such stories
  125. with newlines added will be marked with an asterisk on the stories
  126. selection menu, and when the user is reading the story, they can choose
  127. to read from the start, or just the new lines.
  128.  
  129. I removed the option of adding ANSI with the F-keys from the editor. Sorry,
  130. but the code was taking up a bit of space, and not used all that much. It
  131. speeds up the modem.in routines in the editor a little. It also prevents
  132. the problems we've had with line noise entering a weird ANSI code.
  133.  
  134. The stories will now be saved with a few extra lines to indicate when they
  135. were written, so the [N]ew Lines option works. The users now don't have
  136. to use their real names with the stories (It asks 'Use an Alias?'), and
  137. entering the date is optional. The users will not see the extra lines
  138. added when they read a story, however it's possible to use the Sysop
  139. Maintenance section to do this, for level 9 users ONLY. I decided to leave
  140. the [M]aintenance option displayed on the main menu, but if a user of less
  141. than level 9 attempts it, he won't get all that far! 
  142.  
  143. Maintenance gives you two more options: Delete a story and Rename a 
  144. story. Deleting a story doesn't really delete the story file, it will
  145. simply remove it from the menu file, and rename it on disk to
  146. StoryName.deleted. You can easily fix it up by adding it back to the
  147. 'stories' file, and renaming it back. The Rename A Story gives you the
  148. option to change a story name, if it has gotten so far off-topic the
  149. title bears no relation to the story contents!
  150.  
  151. Story Names can now be upper OR lowercase.
  152.  
  153. I nearly forgot, but page pausing is now suported. This calms the door
  154. operation down a bit! The page pause setting is obtained from the userlog
  155. file when it loads up, so the users have the same values set in the door
  156. as they do back on the BBS.
  157.  
  158. Of course, it's always possible to change the Page Pause setting and toggle
  159. ANSI on and off from the main door menu itself if you like.
  160.  
  161. Two new files will be created when the door is run the first time. I added
  162. code so you don't have to muck around yourself too much. The first file is
  163. the stories.index file which has two lines. The first is the number of
  164. times the door has been invoked, the second is the number of users who've
  165. ever entered the door. I don't recommend you changing the second line of
  166. this file, however if you do, your random file 'stories.visitors' must
  167. match this setting. Ensure that the byte size of 'stories.visitors'
  168. divided by 32 equals this second line in the index file. If you can't
  169. work out what I'm saying here, DON'T change the second line!
  170.  
  171. The other file is a random file called 'stories.visitors'. This cannot be
  172. edited in a text editor, and contains a list of the door users, and the
  173. index number for the last time they used the door. This is so the door
  174. knows whether there are new lines in the stories or not. I chose to
  175. field this file with a data length of 32, so if you load it up into
  176. NewZap, editing this file is quite easy (newzap displays 32 character
  177. columns). The file simply contains the username (25 chars) and the index
  178. number of the last visit (7 chars).
  179.  
  180. Observation shows that this door can run 9,999,999 times before an overflow
  181. occurs in the index number. If any sysop has this door run 10 million
  182. times, it will be necessary to set the index number down a bit. Let me
  183. know when you get to about 9 million invocations, and I'll modify the
  184. program :-)
  185.  
  186. Well, that's just about it... If you can think of any more additions this
  187. door needs, let me know. Especially on the Sysop Maintenance side of things.
  188.  
  189.  
  190. Distribution:
  191. ~~~~~~~~~~~~~
  192.  
  193. Since I basically pinched a large chunk of Percy's code, I cannot claim
  194. any rights to this one! Many code fragments from this door will be used in
  195. later doors I do in GFA. I haven't done all that much in regard to doors
  196. in the last month (I've been playing with the Metro Code itself), but on
  197. the cards are Time Banking (for which it will be necessary to use my version
  198. of the dhandler) and another, better BBS lister, based on Ben Margolin's
  199. Masterfile BBS list.
  200.  
  201. You never know what else I'll come up with!! Until then.
  202.  
  203.                         - Peter Deane
  204.  
  205. --------------------------------------------------------------------------
  206. v2.0 24 November 1994
  207. --------------------------------------------------------------------------
  208.  
  209. The door has been recompiled for OzMetro and had a couple of changes
  210. made to it.
  211.  
  212. Firstly, the window is a lot better, the screen title disappearance bug
  213. is gone, the screen is sent to the back and not made active on a remote
  214. call, pressing both mouse buttons brings up a requester, rather than
  215. just quitting outright, the mystical window on the workbench screen is
  216. no longer opened (that took a while to find), and the s:Metro.cfg is
  217. where all the settings are obtained from.
  218.  
  219. Under OzMetro, ALL doors except the two logoff doors get a ram:DoorData
  220. file written for them, so the note above about not being able to find
  221. the ANSI setting doesn't apply unless you're running this as DOOR1000
  222. from the logoff menu.
  223.  
  224. If you're setting this up the first time, don't panic about the above
  225. notes.  All you have to do is copy the Door.exe to a vacant DOORx
  226. directory.  That's it.  The door creates all the files it needs on its
  227. first run, if they are not already there.
  228.  
  229. The only time you have to worry about the files if you want to start
  230. editing things!  Be aware there is some rudimentary Sysop Maintenance
  231. from the door itself.
  232.  
  233.  
  234. Contact Me:
  235. -----------
  236.  
  237. Postal:
  238.  
  239. Peter Deane
  240. PO Box 228
  241. Swansea  NSW  2281
  242. AUSTRALIA
  243.  
  244. Call Inquestor BBS 24 Hours:
  245.  
  246. 011-61-49-72-1647 from the USA
  247. (049) 72-1647 from within Australia
  248.  
  249.  
  250.